home *** CD-ROM | disk | FTP | other *** search
/ Atari Forever 4 / Atari Forever 4.zip / Atari Forever 4.iso / SERIE_AI / AI_123 / STOOP105 / STOOP.TXT < prev   
Text File  |  1998-03-14  |  46KB  |  1,213 lines

  1.                 STOOP Manual
  2.                 Version 1.05
  3.  
  4.  
  5. Hardware required
  6.  
  7. Atari Falcon with 4Mb RAM and a VGA or SVGA display is recommended, 
  8. but it can be used with an RGB monitor (the screen resolution needed 
  9. for Stoop is a minimum 640 x 480 by 16 colours).
  10.  
  11. Contents
  12.     Introduction
  13.     Getting Started
  14.     Setting Up Stoop
  15.         Boards
  16.             Editing a Board
  17.             Changing Boards
  18.             Deleting a board
  19.             Using Font Folders With NVDI 3
  20.         Buttons
  21.             Setting Up A Button
  22.             Showing A Button's Configuration
  23.             Deleting a Button
  24.             Merging & Removing Files from Buttons
  25.             Copying Buttons
  26.             Swapping Buttons
  27.             Using a Button
  28.    Last Configuration
  29.         Passing Parameters to Auto-Booting Programs
  30.             Setting Up Stoop for Passing Parameters
  31.             Text Window Keyboard Commands
  32.             Environment Options
  33.             Problems With Passing Parameters
  34.         Groups
  35.             Using a Group
  36.             Deleting a Group
  37.     The File Selector
  38.         Copying Folders & Files
  39.         Moving Folders & Files
  40.         Deleting Folders & Files
  41.         Renaming Folders & Files
  42.         Creating Folders
  43.         Re-Ordering the AUTO Folder
  44.         Hiding Files from Stoop
  45.     Main Controls
  46.         GO & EXIT
  47.         Auto-Booting Programs
  48.     Option Controls
  49.         FSEL
  50.         DELETE
  51.         SAVE
  52.         CLEAR
  53.         CONFIG
  54.             SYSTEM Dialogue
  55.             INITIAL Dialogue
  56.             START UP Dialogue
  57.             COLOURS Dialogue
  58.     Manual Start Up Configurations
  59.     
  60.  
  61. Introduction
  62.  
  63. Stoop is a boot manager for the Atari Falcon. It has its own graphical 
  64. interface and uses the mouse for most operations though it does make some 
  65. use of the keyboard.
  66.  
  67. Stoop can :
  68.  
  69. ≡    Be used to determine which AUTO programs, accessories, CPX 
  70.     modules and NEWDESK.INF files should be active when starting 
  71.     up or re-booting. ≡    Control other types of file (e.g. GDOS 
  72.     ASSIGN.SYS files) to a maximum of 20 different types.
  73.  
  74. ≡    Display up to 512 file names in each of 20 boards. These 
  75.     boards have to be paged to view all of the file names, but 
  76.     paging buttons will only appear when they are necessary.
  77.  
  78. ≡    Either change the extension of a file name to make it 
  79.     active/inactive, e.g. ACX is changed to ACC and vice versa, 
  80.     (the file may be also moved to another folder at the same 
  81.     time) this can be done for a maximum of 254 files per file 
  82.     type. Or a single file can copied and renamed to a specific 
  83.     name, e.g. C:\AUTO\STOOP\GENERAL.INF may become NEWDESK.INF.
  84.  
  85. ≡    Make groups of files which may be selected or de-selected by a 
  86.     single button press, to a maximum of 50 files per board per 
  87.     group, and since there is a maximum of 20 boards a maximum of 
  88.     1000 files can be assigned per group.
  89.  
  90. ≡    Control the screen resolution of the desktop that appears 
  91.     after booting, including starting up in ST compatible screens, 
  92.     without having to use a specific NEWDESK.INF file.
  93.  
  94. ≡    Change the application the desktop runs after boot-up.
  95.  
  96. ≡    Store often used start-up configurations on buttons, to a 
  97.     maximum of 27.
  98.  
  99. ≡    Copy, delete and move folders and files, and also rename 
  100.     files, using its own file selector.
  101.  
  102. ≡    Re-order the contents of the AUTO folder.
  103.  
  104. ≡    Hide files from itself so that they cannot be 
  105.     selected/de-selected for boot-up by error. Up to 50 files can 
  106.     be hidden.
  107.  
  108. ≡    Be easily configured while running from the AUTO folder.
  109.  
  110. ≡    Pass parameters to applications that are to be auto-booted.
  111.  
  112. ≡    Be booted in any resolution on a RGB or VGA monitor.
  113.  
  114. ≡    Display folders instead of files in a board, this is primarily 
  115.     for moving folders of fonts in and out of NVDI 3's font 
  116.     directories, which means that you can choose which fonts to 
  117.     use at boot up more easily by selecting a family or group of 
  118.     fonts with a single mouse click.
  119.  
  120. ≡    Protect your system with a password.
  121.  
  122. ≡    Now wait for a set period and then, if not used, it will set 
  123.     up a default configuration and exit.
  124.  
  125. ≡    Swap preset buttons around.
  126.  
  127. ≡    Copy preset buttons.
  128.  
  129. ≡    Show an unlimited number of files and folders in the 
  130.     fileselector in a single directory, it is now only limited by 
  131.     available memory.
  132.  
  133. ≡    Merge and remove file names with/from preset configurations.
  134.  
  135. ≡    Change the speaker volume and balance.
  136.  
  137. ≡    Turn off the keyclick and the system bell sounds.
  138.  
  139. ≡    Change the colours used by Stoop.
  140.  
  141. ≡    Select an auto-booting program for a one-off configuration 
  142.     more easily.
  143.  
  144. Also in version 1.05, I have endeavoured to erradicate all the bugs, 
  145. these were mostly minor, but I have had to rewrite the memory handling 
  146. routines so that large configurations can be used.
  147.  
  148.                 Getting Started
  149.  
  150. Installing Stoop
  151.  
  152. Run the INSTALL program, make sure that the STOOP and LAUNCH program 
  153. files are in the same directory as INSTALL before starting.
  154. INSTALL will modify any STOOP.CFG it finds, backup this file first (e.g. 
  155. copy it to another directory) and it will place STOOP at the start of the 
  156. AUTO folder or copy it into the same position as the earlier version of 
  157. Stoop if you have one.
  158.  
  159. When running at boot up, Stoop has a problem with NVDI. Please make 
  160. sure that the STOOP program runs before NVDI.
  161.  
  162.  
  163.                Setting Up Stoop
  164.  
  165. To start up Stoop after installation, you can either re-boot or run it 
  166. from the Desktop.
  167.  
  168. When you have started Stoop up you should see a screen divided into 
  169. three main areas; the largest area is the boards where all of the 
  170. files will be displayed, to the right of it is the control panel 
  171. containing various buttons with a board labelled GROUPS and at the 
  172. bottom of the screen are 27 buttons which can be used to store preset 
  173. start up configurations.
  174.  
  175.  
  176.                 Boards
  177.  
  178. The first step should be to arrange the boards to display the required 
  179. files. Each board shows the files which match one of two extensions 
  180. (e.g. PRG and PRX) that exist in one folder or root directory.
  181.  
  182. There are 5 boards which you can re-configure, each one can have 4 
  183. different faces. Each board can be displayed as either one long board 
  184. or two short ones.
  185.  
  186. When you first run Stoop there may not be a STOOP.CFG file present 
  187. which contains the configuration information for Stoop, hence Stoop 
  188. will use it's default configuration. The first two boards should show 
  189. the program files in the AUTO folder and the accessories on the root 
  190. directory of your boot drive.
  191.  
  192. These boards may be altered to show different types of file (different 
  193. file extensions) and/or the files in different folders or drives.
  194.  
  195. To alter a board, click on the BOARD button (right hand side of 
  196. screen) and then click on the board you want to change. A dialogue 
  197. should pop up which displays the current details of that particular 
  198. board:-
  199.  
  200. TITLE
  201. The name of the board which is to be displayed just above the top of 
  202. the board.
  203.  
  204. SOURCE PATH
  205. The folder or drive which will hold the files or folders to be shown 
  206. on the board.
  207.  
  208. DESTINATION PATH
  209. The folder or drive which the file or files or folders will be copied 
  210. to (this MUST be given even if it is the same as the SOURCE PATH). If 
  211. folders are to be displayed on the board, the destination path MUST be 
  212. (i) different to the source path and (ii) outside of the source 
  213. directory, i.e. it must NOT be in the source directory OR be a 
  214. subdirectory of the source directory.
  215.  
  216. DESTINATION FILE
  217. The name that will be given to a single file once it has been copied. 
  218. If this box contains any text then only one file may be selected on 
  219. the board at any one time, otherwise any number (zero to all) of files 
  220. can be selected. If the board is set to use folders, this will be 
  221. empty.
  222.  
  223. LIVE & DEAD EXTS
  224. These are the file extensions of the files that will be shown on the 
  225. board. The 'live' extension is the one that active files have (e.g. 
  226. PRG or ACC) while the 'dead' extension is the one that inactive files 
  227. will be given which usually terminates with an 'X' (e.g. PRX or ACX). 
  228. If the board is set to use folders, these sections will be empty.
  229.  
  230. FILES/FOLDERS button
  231. This button will toggle between FILES and FOLDERS. When FILES is 
  232. displayed, the board will show a list of files from the source 
  233. directory and when FOLDERS is shown, the board will show a list of the 
  234. folders from the source directory. The folders in BOTH of the paths 
  235. (source and destination) will be displayed on the board, the names of 
  236. folders in the source will be highlighted to show that they are 
  237. active, and the names of folders in the destination will NOT be 
  238. selected. Any folders that are highlighted on the board will be moved 
  239. to the source directory when Stoop sets up the configuration, and any 
  240. folders that are not highlighted are moved to the destination 
  241. directory.
  242.  
  243. SHORT/LONG button
  244. This button will toggle between showing SHORT and LONG on it's 
  245. surface. When it shows LONG, one long board will appear at the chosen 
  246. position and it will display up to 34 file names, and when it shows 
  247. SHORT there will be 2 short boards displayed showing up to 16 file 
  248. names each.
  249.  
  250. OK and CANCEL
  251. These have their usual meanings, they both let the user quit the 
  252. dialogue but OK confirms any changes and CANCEL ignores them. Most of 
  253. the above is straight forward, but the use of the DESTINATION FILE 
  254. needs explaining. Some programs use INF (or similar) files to hold 
  255. data about the program's start up settings, e.g. the Desktop is one 
  256. such program and it uses NEWDESK.INF. If you want to start up these 
  257. programs with different settings, depending upon your needs, the INF 
  258. file has to be replaced with another version. For Stoop to do this 
  259. automatically for you it needs the name of the INF file, this is what 
  260. DESTINATION FILE should hold.
  261.  
  262. Example #1.
  263.  
  264. Suppose the dialogue holds the following data :-
  265.  
  266.     TITLE            = NEWDESK
  267.     SOURCE PATH        = C:\AUTO\STOOP 
  268.     DESTINATION PATH    = C:\
  269.     DESTINATION FILE    = NEWDESK.INF
  270.     LIVE EXT        = INF
  271.     DEAD EXT        = INX
  272.     first button        = FILES
  273.     second button        = SHORT
  274.  
  275. This allows a user to have different set-ups for the Desktop. Any 
  276. files contained in C:\AUTO\STOOP (but not any folders within it) that 
  277. have INF or INX extensions will be displayed upon the board, INF files 
  278. will be highlighted and INX files will not.
  279.  
  280. The SHORT button means that two short boards will be shown in the 
  281. chosen column, the other board may appear above or below the board you 
  282. are setting up.
  283.  
  284. Suppose that the folder C:\AUTO\STOOP contains these three files:-
  285.  
  286.     GENERAL.INX
  287.     DTP.INX
  288.     SBLASTER.INF
  289.  
  290. Their names will appear on the board without their extensions, only 
  291. SBLASTER is highlighted as it's extension is 'live' (it has INF for 
  292. it's extension).
  293.  
  294. Selecting GENERAL on the board will highlight it and un-highlight 
  295. SBLASTER. Clicking on the GO button will cause GENERAL.INF to be 
  296. copied to drive C and named NEWDESK.INF (the previous NEWDESK file is 
  297. first deleted).
  298.  
  299. Example #2.
  300.  
  301. Suppose the boxes hold the following data :-
  302.  
  303.     TITLE            = ACCESSORIES
  304.     SOURCE PATH        = C:\ 
  305.     DESTINATION PATH    = C:\
  306.     DESTINATION FILE    =
  307.     LIVE EXT        = ACC
  308.     DEAD EXT        = ACX
  309.     first button        = FILES
  310.     second button        = LONG
  311.     
  312. This allows a user to change the accessories loaded at boot up. Note 
  313. that DESTINATION FILE should contain no text.
  314.  
  315. With this information, Stoop will show all the files in the root 
  316. directory of drive C which have either ACC or ACX extensions on the 
  317. board. Files with 'live' extenders (ACC) will be highlighted while 
  318. files with 'dead' extensions will not. Clicking on a 'dead' file will 
  319. make it live without changing the status of any other file and 
  320. clicking on a 'live' file will make it 'dead'.
  321.  
  322. Clicking on GO will cause all files to be renamed according to their 
  323. status on the board, highlighted names become 'live' (they are given 
  324. the ACC extension) and all of the others are 'killed' (given ACX 
  325. extenders).
  326.  
  327. Note that although TOS 4 only allows a maximum of 6 accessories to be 
  328. loaded at any one time, Stoop will not stop you from selecting more 
  329. than 6 accessories.
  330.  
  331. If the SOURCE and DESTINATION PATH's were different in the above 
  332. example, the files would be re-named and they would be copied to the 
  333. DESTINATION PATH, but please note that any existing files in the 
  334. DESTINATION PATH would be unaffected. Hence avoid using different 
  335. SOURCE and DESTINATION PATH's when multiple files are to be made 
  336. 'live' (i.e. DESTINATION FILE is undefined) as any files copied there 
  337. by Stoop during a previous boot up will still be there.
  338.  
  339. The FILES button means that the board will only display the names of 
  340. folders.
  341.  
  342. The LONG button means that one long board will be shown in the chosen 
  343. column.
  344.  
  345.  
  346. Editing A Board
  347.  
  348. Now that you now what the boards can do, how do you change them to do 
  349. what you want?
  350.  
  351. There are basically two types of boxes which contain text on this 
  352. dialogue,
  353.  
  354. (i)    Boxes which can be edited manually by placing the cursor in it 
  355.     and adding characters from the keyboard.
  356.  
  357. (ii)    Boxes which you click on and this brings up the file selector. 
  358.     This type is used to hold file paths and names which are 
  359.     selected via the file selector.
  360.  
  361. TITLE
  362. If the text cursor is not in the Title box you can (i) click the mouse 
  363. on it, (ii) press TAB or (iii) press the up or down arrow keys to move 
  364. it into the box. You can then type the new name, BACKSPACE will delete 
  365. back one character and ESC will clear all of the text. Do not press 
  366. RETURN or ENTER unless you want to exit the dialogue and confirm the 
  367. changes (this is equivalent to clicking on the OK button).
  368.  
  369. SOURCE PATH
  370. Click the mouse on the text area of this box, the file selector will 
  371. appear and you can choose the path you require.
  372.  
  373. DESTINATION PATH
  374. Use the same procedure as for the SOURCE PATH.
  375.  
  376. DESTINATION FILE
  377. Use the same procedure for the Title text box.
  378.  
  379. LIVE EXT
  380. Use the same procedure for the Title text box.
  381.  
  382. DEAD EXT
  383. Use the same procedure for the Title text box.
  384.  
  385. FILES/FOLDERS
  386. Click on this to toggle it's setting.
  387.  
  388. SHORT/LONG
  389. Click on this to toggle it's setting.
  390.  
  391.  
  392. Changing Boards
  393.  
  394. There are 20 boards, but only five to ten can be shown at any one 
  395. time, to show the others click anywhere on the board with your RIGHT 
  396. mouse button, this will cycle through the boards for that position.
  397.  
  398. Each column has four boards. If the board in a column is a long board 
  399. the other three are hidden below it and 3 clicks will top each of 
  400. these boards in turn, a fourth click will show the first board again. 
  401. If the column has two short boards, then 2 of the four boards are 
  402. already in view and each of the short boards has only one other board 
  403. under it, hence 1 click on a short board will top the board underneath 
  404. and another click will then return to the initial board.
  405.  
  406.  
  407. Deleting A Board
  408.  
  409. Click on the DELETE button on the control panel, then click on the 
  410. board and everything for that board will be returned to the default 
  411. settings.
  412.  
  413.  
  414. Using Font Folders With NVDI 3
  415.  
  416. NVDI 3 can use fonts files which are held in folders within the 
  417. directory or directories specified in the NVDI.INF file. This makes it 
  418. possible to group fonts into families and select or deselect the group 
  419. in one operation instead of having to find and alter each fint file. 
  420. You may choose to group your fonts in a different scheme, e.g. body 
  421. fonts, display fonts and symbol fonts, however NVDI does not provide a 
  422. simple way of doing this. Stoop can help you control your fonts, 
  423. either selecting individual font files or folders containing font 
  424. files. The following shows how to use Stoop to control folders.
  425.  
  426. Suppose your Speedo fonts are held in folders in C:\GEMSYS\SPEEDO, to 
  427. set up a board the following data should be used to set up a board :-
  428.  
  429.     TITLE            = SPEEDO
  430.     SOURCE PATH        = C:\GEMSYS\HIDE.SPD
  431.     DESTINATION PATH    = C:\GEMSYS\SPEEDO
  432.     DESTINATION FILE    =
  433.     LIVE EXT        = 
  434.     DEAD EXT        = 
  435.     first button        = FOLDERS
  436.     second button        = LONG
  437.  
  438. The FOLDERS button means that the board will only display the names of 
  439. folders.
  440.  
  441. This allows a user to change the Speedo fonts to be used by NVDI 3. In 
  442. this example, the source path must be the same as a font path set in 
  443. NVDI 3 INF file (i.e. FONTPATH = C:\GEMSYS\SPEEDO\).
  444.  
  445. Initially, with this information, Stoop will show all the folders in 
  446. the GEMSYS\SPEEDO directory, which can have any file name extension, 
  447. on the board. Folders in this directory will be highlighted. Stoop 
  448. will also show all of the folders in the GEMSYS\HIDE.SPD directory, 
  449. but these will not be highlighted.
  450.  
  451. Once the board is displayed, the folders can be selected or deselected 
  452. and after clicking on GO, the folders will be moved to their 
  453. appropriate positions. If folders are selected they will be moved to 
  454. SPEEDO folder and if they are unhighlighted they will be moved to the 
  455. HIDE.SPD folder.
  456.  
  457. The destination directory, in this example C:\GEMSYS\HIDE.SPD, should 
  458. be outside of the source folder AND it must be in the SAME PARTITION, 
  459. if it is not things may be go wrong. If you are using two boards with 
  460. folders, DO NOT use the same destination folder as any extensions 
  461. (.TTF, .DOC, etc.) are not used to tell them apart, so they will get 
  462. mixed up and appear in both boards which will cause problems.
  463.  
  464.  
  465.                 Buttons
  466.  
  467. At the bottom of the screen are three rows of nine buttons, all of 
  468. these buttons can have a particular set-up assigned to them. There are 
  469. only nine buttons per row because of the font size and number of 
  470. characters (8) used for the legend on each key, if it were smaller it 
  471. would not look as good. Twenty-seven set-ups should be enough for 
  472. everyone but if they are not please write or email.
  473.  
  474. To select them you can either click the mouse on them or you can use a 
  475. function key. The top row can be accessed by pressing just the 
  476. function key (F1-F9), the middle row needs the Control key to be 
  477. pressed while the function key is being pressed (CTRL F1-CTRL F9) and 
  478. the bottom row needs the Alternate to be pressed while the function 
  479. key is pressed (ALT F1-ALT F9). To make things a little easier to 
  480. remember (there are no prompts about which modifier key to use, 
  481. Control or Alternate), the Control key is physically above the 
  482. Alternate key on the keyboard and the screen buttons which use the 
  483. Control key (middle row) are physically above the buttons which use 
  484. the Alternate key (bottom row).
  485.  
  486. For users who would like to use the F10 function key, this is now 
  487. possible, but additional buttons are not available, instead pressing 
  488. F10 is the same as pressing Control F1 and Control F10 gives the same 
  489. result as pressing Alternate F1. Alternate F10 has alias and produces 
  490. no result. This enables those users, who have set up the 10 function 
  491. buttons on the Desktop to call programs, to use the same function 
  492. buttons in Stoop to autoboot the same programs.
  493.  
  494.  
  495. Setting Up A Button
  496.  
  497. Once you have set up the boards, you can begin assigning combinations 
  498. of files, a screen resolution and a auto-booting program to one of the 
  499. buttons at the bottom of the screen.
  500. There are two ways of doing this. If you want to set up only a single 
  501. button, follow the following instructions.
  502.  
  503. 1.    Select all of the files on the boards that you want to be 
  504.     active for a particular task (do not forget that the hidden 
  505.     panels may have selected files (use the CLEAR button to 
  506.     de-select all files).
  507.  
  508. 2.    Choose your resolution, if you want to use a Falcon screen 
  509.     mode first choose the number of colours required by clicking 
  510.     on one of the five buttons labelled 2,4,16,256 and TC (top 
  511.     left of control panel), then adjust the number of horizontal 
  512.     pixels (640 or 320) and the vertical resolution (480 or 240 
  513.     pixels) by clicking on the 2 buttons just below the colour 
  514.     resolution buttons.
  515.  
  516. 3.    Click on the BUTTON button (right side of control panel). 
  517.     Click on the button you want to assign the current set up to, 
  518.     a dialogue will appear.
  519.  
  520. LEGEND
  521. Here you can enter two lines of text which will appear on the button, 
  522. example DTP and 2 could be used to denote a DTP set up in 2 colours 
  523. (monochrome). Use the mouse, TAB or the arrow keys to move to the 
  524. second line.
  525.  
  526. AUTO BOOT
  527. Clicking on this text box will bring up the file selector, you can 
  528. then choose the program you want to run when the Desktop starts up..
  529.  
  530. OK and CANCEL have their usual meanings.
  531.  
  532. The same editing keys used for the BOARD dialogue are also used with 
  533. this dialogue.
  534.  
  535. If you want to set up several buttons, you can repeat the previous 
  536. instructions  for each button or you can click on the BUTTON button 
  537. first and then click on the SET UP button which then appears. You then 
  538. set up the files you want by selecting them on the boards and then you 
  539. click on the preset button you want to use, the dialogue for setting 
  540. the title, etc.,  of the button will then appear. You can repeat this 
  541. as often as you like, but when you finish you can click on SET UP or 
  542. BUTTON to stop.
  543.  
  544.  
  545. Showing A Button's Configuration
  546.  
  547. To show which files make up the configuration of a button, click with 
  548. the RIGHT button on the button.
  549.  
  550. If you want to change the parameters of a button sent to the Launch 
  551. program, click on the button while holding down the Alternate key. 
  552. This will also show the files belonging to that button.
  553.  
  554.  
  555. Deleting a Button
  556.  
  557. Click on the DELETE button (lower right of control panel) and then 
  558. click on the button to be deleted.
  559.  
  560. If you want to make a lot of deletions, click on BUTTON and then on 
  561. DELETE. Every button you click on, from now until you click on BUTTON 
  562. or DELETE again, will be wiped - so BECAREFUL.
  563.  
  564.  
  565. Merging & Removing Files from Buttons
  566.  
  567. Files can be added or removed from a button very easily. Click on 
  568. BUTTON, then select either MERGE to add files or REMOVE to delete them 
  569. from the button(s). Any highlighted file on the boards should been 
  570. deselected. Choose the files you want added or removed and then select 
  571. the button(s) that you want changed (this can be done either order or 
  572. even mixed up). Finally, choose the MERGE or REMOVE button (which ever 
  573. you have already selected) and the changes will be made.
  574.  
  575.  
  576. Copying Buttons
  577.  
  578. If you want to make a configuration for a button which is very similar 
  579. to another one already set up, you can copy it in two ways. You can 
  580. show the configuration already set up by clicking on it's button with 
  581. the RIGHT mouse button, then you can make the changes to it and assign 
  582. the new configuration to another button.
  583.  
  584. The other way is to click on BUTTON and then on COPY. Then you should 
  585. click on COPY to deselect it and then make the changes as normal, this 
  586. method also copies everything which makes setting up the same 
  587. configuration for different screen resolutions easier.
  588.  
  589. If you are going to make several copies, make each copy and then use 
  590. the SET UP button to make the changes to each one, this means that 
  591. BUTTON will not have to be reselected for each button.
  592.  
  593.  
  594. Swapping Buttons
  595.  
  596. Buttons can be rearranged so that you can reorder or group together 
  597. similar set ups. Click on BUTTON and then on SWAP. Then simply click 
  598. on the two buttons you want to swap. To stop, click on BUTTON or SWAP.
  599.  
  600.  
  601. Using a Button
  602.  
  603. Once a preset button has been set up, a single mouse click is all that 
  604. is needed to use it. When this happens, Stoop displays the 
  605. configuration belonging to the button and then changes the files 
  606. (selected files are made active, un-selected are made inactive), it 
  607. then changes NEWDESK.INF so that the correct screen resolution will be 
  608. used and that the auto boot program (if there is one) is automatically 
  609. run when the Desktop starts up.
  610.  
  611. The preset configurations can also be activated by using the function 
  612. keys,
  613.     F1..F9            will select one of the top row buttons,
  614.     Control F1..F9        will select a middle row button and
  615.     Alternate F1..F9    will select a bottom row button.
  616.  
  617. In addition, F10 is aliased with Control F1, hence pressing F10 is the 
  618. same as pressing Control F1, and pressing Control F10 is equivalent to 
  619. pressing Alternate F1. Alternate F10 does not have an alias.
  620.  
  621.  
  622. Last Configuration
  623.  
  624. When Stoop starts up, it will attempt to find the previous 
  625. configuration used and indicate the preset button it belongs with a 
  626. red rim around the button. When you press another preset button, the 
  627. red outline will be transferred to it.
  628.  
  629.  
  630.        Passing Parameters to Auto-Booting Programs
  631.  
  632. Stoop can now pass parameters to auto-booting programs, though this is 
  633. not reliable as it should be because of bugs in TOS 4 or Lattice C 
  634. which do not allow the path for a drive or partition to be set.  
  635. Environment strings can also be set at the same time.
  636.  
  637. To pass parameters to a program another program is needed, in this 
  638. case Launcher.prg, which is run instead of the required program and 
  639. then calls the program that you want to use. Launcher has to load in 
  640. details, prepared by Stoop, which contain the program's name and the 
  641. other data such as the filename(s) to be passed and the environment 
  642. strings to be set.
  643.  
  644.  
  645. Setting Up Stoop for Passing Parameters
  646.  
  647. The parameters are attached to the  preset  buttons  so  that  when  
  648. you select a preset configuration to be set up the parameters will be 
  649. set up as well.
  650.  
  651. To set up for passing parameters, set up a button for normal 
  652. operation, see the section 'Button', but after you have given the 
  653. button a name select the LAUNCH button on the dialogue.  A new 
  654. dialogue  will appear which has two windows, called tail and 
  655. environment.
  656.  
  657. These windows can be have text entered into them in two  ways,  you  
  658. can type directly into them or you can  use  the  file  selector  to  
  659. either insert the text from a file or the full name of the file in the 
  660.  window. Whatever you choose, the new text will appear at the cursor 
  661. position.
  662.  
  663. The tail window should contain  the  parameters  to  be  passed  to  
  664. the program you want  to  use,  this  includes  filenames  or  command 
  665.  line parameters.
  666.  
  667. To enter text into either window using the file selector.
  668.  
  669. First move the cursor to the line where you  want  the  text  to  
  670. appear (see below for keyboard commands), then call the file selector 
  671. with the FSEL button, select the file you want and press OK. Another 
  672. dialogue now appears, this gives you three choices; INSERT, PUT NAME 
  673. or ABORT.
  674.  
  675. INSERT
  676. Choosing this button will put the text contained in the file into your 
  677. window. (WARNING - only try this with small files of about 10k 
  678. length).
  679.  
  680. PUT NAME
  681. This will put the file name, including it's full path, in the window.
  682.  
  683. ABORT
  684. Allows you to abort making changes to the text in the window.
  685.  
  686. Example, if the program for which you are setting the button up is 
  687. Gemview, you can put the names of picture  files  you  want  Gemview  
  688. to automatically load and display when you  auto-boot  it.  (Use  the  
  689. FSEL button and PUT NAME to enter the picture files, you can only do 
  690. this one at a time.)
  691.  
  692.  
  693. Text Window Keyboard Commands
  694.  
  695. The four cursor keys move the cursor as normal (left, right, up or 
  696. down one space).
  697.  
  698. Holding a SHIFT key down with either of the left and right cursor keys 
  699. to move the cursor to the  start   or   end   of   the current line 
  700. respectively.
  701.  
  702. Holding a SHIFT key down with either of the up and down cursor keys 
  703. will page the text up or down respectively.
  704.  
  705. RETURN will add a new line below the current line the cursor is  on.  
  706. If the cursor is in the middle of the line, the text will be split  
  707. between the lines.
  708.  
  709. DELETE will delete the character the cursor is covering. If  the  
  710. cursor is at the end of the line, this line and the one below will  be 
  711. joined, (any characters over the maximum character line length will 
  712. be left on the next line).
  713.  
  714. BACKSPACE will delete the character in front of the cursor. If the 
  715. cursor is at the start of the line, this line and the one above will 
  716. be joined, (any characters over the maximum character line length will 
  717. be left on the line).
  718.  
  719. TAB will change the window the cursor is in (this may also be done  
  720. with a click of the mouse on the required window).
  721.  
  722. CTRL - Y (hold the Control key down, press Y key before letting  go  
  723. of Control) will delete the current line. (BUG - the first line cannot 
  724. be deleted in this way, to get around  this put the cursor on the 
  725. first character and press return to move the  line to the next row and 
  726. then delete, or just use the  Backspace  and  Delete keys to remove 
  727. individual characters.)
  728.  
  729. CTRL - U (hold the Control key down, press U key before letting  go  
  730. of Control) will put the last line to  be  deleted  by  CTRL  -  Y  at 
  731. the current position of the cursor.
  732.  
  733. These commands are fairly basic, but they are not intended  to  be  
  734. used with large amounts of text.
  735.  
  736. NB. The maximum line length is 125 characters, if this is too small, 
  737. please let me know.
  738.  
  739.  
  740. Environment Options
  741.  
  742. Just below the Environment window are two recessed displays clicking  
  743. on the first of these will present options which can increase the 
  744. usefulness of environment strings. These options will appear on a 
  745. pop-up window in the middle of the screen, they are :-
  746.  
  747. SEND TO PROGRAM ONLY
  748. This is the  default  setting,  the  contents  of the environment 
  749. window are sent to the launcher program which then  sets them up for 
  750. the program it will launch.
  751.  
  752. SEND TO FILE ONLY
  753. The environment window contents are sent to a  file, the name of the 
  754. file can be chosen using the file selector  by  clicking on the second 
  755. recessed display.
  756.  
  757. This will allow users of MultiTos to edit a MINT or GEM configuration 
  758. file before launching MultiTos. Other programs which have an editable 
  759. configuration file may also benefit from this option.
  760.  
  761. If this is popular, I will add the ability to edit more than one file.
  762.  
  763. IGNORE ENVIRONMENT
  764. The contents of the environment window are not used in any way.
  765.  
  766.  
  767. Problems With Passing Parameters
  768.  
  769. For some reason unknown to me, I cannot set the current path on a 
  770. drive. This is a bug in either TOS 4.04 or in Lattice C  5.60.  Please 
  771. let me know if this is a known bug - and if a fix is possible.
  772.  
  773. This only causes problems with a few programs which I believe  look  
  774. for their .RSC and .INF files in the current  directory  for  their  
  775. current drive. The only program that I found that does this is  
  776. Papyrus  and  to get around it put the .RSC and .INF files  it  looks  
  777. for  in  the  root directory of drive C (or A if you do not have a 
  778. harddrive).
  779.  
  780. *** WARNING ***
  781.  
  782. While Stoop does and display files containing odd characters in their 
  783. names, it cannot assign them properly to a button or group. However 
  784. these file names cause BIG problems if you try to hide them from Stoop 
  785. (see section on the file selector later on).
  786.  
  787.  
  788.                 Groups
  789.  
  790. A set of files can be assigned to a Group, this allows you to set up 
  791. groups of common files this makes setting up preset buttons quicker 
  792. but is more useful for when you want start up your Falcon in a one-off 
  793. configuration.
  794.  
  795. Example, the files UISIII(.PRG) in the AUTO folder could be grouped 
  796. with CALL_UIS(.ACC) and assigned to a group called UIS, when UIS is 
  797. clicked on both of these files will be selected.
  798. To set up a group :-
  799.  
  800. 1.    Select the files on the boards you want assign to the group, all 
  801.     other files must be inactive.
  802.  
  803. 2.    Click on the GROUP button (right side of control panel) and then 
  804.     click on the GROUP board, a simple dialogue will appear.
  805.  
  806. 3.    Type in the name to be given to the group. Then exit. The name 
  807.     will appear in alphabetical order on the GROUP board.
  808.  
  809. To de-select all the files assigned to a group, simply click with the 
  810. Right button on the name in the GROUP board.
  811.  
  812.  
  813. Deleting A Group
  814.  
  815. Click on the DELETE button, then click on the group name on the GROUP 
  816. board to be deleted.
  817.  
  818. *** WARNING ***
  819. While Stoop does and display files containing odd characters in their 
  820. names, it cannot assign them properly to a button or group. However 
  821. these file names cause BIG problems if you try to hide them from Stoop 
  822. (see section on the file selector later on).
  823.  
  824.  
  825.               The File Selector
  826.  
  827. The file selector is divided into several main parts; the PATH and 
  828. FILE text boxes which can be manually edited, the file & folder 
  829. display area, the drive buttons, the file utility buttons and the OK & 
  830. CANCEL buttons.
  831.  
  832. The file selector offers some of the extended facilities offered by 
  833. enhanced GEM file selectors, namely it can COPY, DELETE, MOVE and 
  834. RENAME files and folders, it can also create folders. Also, there are 
  835. two Stoop specific functions it can carry out, it can re-order the 
  836. AUTO folder and it can hide files from Stoop so that they cannot be 
  837. displayed on the boards, but the file selector can still show them (so 
  838. that you can un-hide them).
  839.  
  840. To select a file, just click on it and do this again to de-select it 
  841. or select another file.
  842.  
  843. To enter a folder, just click on it. To select a folder, hold down the 
  844. SHIFT key on the keyboard as you click on it.
  845.  
  846. To select multiple files and folders, hold down a SHIFT key as you 
  847. click on each one. There is NO lasso function using the mouse (I will 
  848. put one in  soon).
  849.  
  850. Copying Folders & Files
  851.  
  852. 1.    Choose the files and folders you want to copy.
  853. 2.    Click on the COPY button.
  854. 3.    Select the folder or drive to copy them to.
  855. 4.    Press RETURN or click on OK.
  856.  
  857. Files cannot be copied on top of themselves, if you try this all copy 
  858. operations are ignored.
  859.  
  860. Moving Folders & Files
  861.  
  862. 1.    Choose the files and folders you want to move.
  863. 2.    Click on the MOVE button.
  864. 3.    Select the folder or drive to move them to.
  865. 4.    Press RETURN or click on OK.
  866.  
  867. Files cannot be moved on top of themselves, if you try this all move 
  868. operations are ignored.
  869.  
  870. Deleting Folders & Files
  871.  
  872. 1.    Choose the files and folders you want to delete.
  873. 2.    Click on the DELETE button.
  874.  
  875. Renaming Folders & Files
  876.  
  877. 1.    Select the file or folder to be renamed, it's name should appear in 
  878.     the FILENAME text box.
  879. 2.    Click on the RENAME button.
  880. 3.    Edit the name in FILENAME to the new name.
  881. 4.    Click on the RENAME button or press RETURN or click on OK.
  882.  
  883. Creating Folders
  884.  
  885. 1.    Type in the name of the new folder in the FILENAME text box.
  886. 2.    Click on the FOLDER button.
  887.  
  888. Re-Ordering the AUTO Folder
  889.  
  890. 1.    Click on the REORDER button, the file selector should now display 
  891.     the contents of the AUTO folder on the boot drive.
  892. 2.    Click on the file you want to move.
  893. 3.    Click on the position you want it to be moved to.
  894. 4.    Repeat these actions as many times as you require.
  895. 5.    Click on the REORDER button or press RETURN or click on OK, the 
  896.     files will then be re-ordered.
  897.  
  898. Note : folders in the AUTO folder cannot be re-ordered.
  899.  
  900. Hiding Files from Stoop
  901.  
  902. 1.    Select the file to be hidden from Stoop.
  903. 2.    Click on the HIDE button.
  904.  
  905. The hidden file will still be visible on the file selector but it's 
  906. name will be in grey rather than black. If the hidden file was visible 
  907. on a board before you hid it, it will disappear from there when you 
  908. exit the file selector.
  909.  
  910. The details of the hidden files have to be added to Stoop's INF file, 
  911. so remember to SAVE after hiding a file.
  912.  
  913. *** WARNING ***
  914. Do not hide files which contain odd characters, while Stoop can 
  915. display the names of such files it has problems with them and CAN 
  916. cause STOOP.CFG to crash Stoop. Try renaming the offending file.
  917.  
  918.  
  919.                 Main Controls
  920.  
  921.  
  922. GO & EXIT Buttons
  923.  
  924. GO
  925. This causes the Stoop to change all selected files on the boards to be 
  926. made active and all un-selected files to become inactive, copies 
  927. required files to folders and then changes the NEWDESK.INF file so 
  928. that the Desktop will start up in the selected resolution and boot the 
  929. current AUTO BOOT program.
  930.  
  931. Stoop the& exits, the AUTO folder programs are run, the accessories 
  932. are loaded and then the Desktop appears.
  933.  
  934. GO is provided so that you can make and use a start-up configuration 
  935. without having to assign it to a button, or make a small change to an 
  936. existing configuration (e.g. change the number of colours or 
  937. resolution), see the information below.
  938.  
  939. EXIT
  940. Clicking on this causes Stoop to exit without making a single change 
  941. to files or NEWDESK.INF.
  942.  
  943.  
  944. Auto-Booting Programs
  945.  
  946. Clicking on the AUTO BOOT window (just above the Stoop logo) will 
  947. bring up a dialogue for selecting the program for the Desktop to run 
  948. after the computer has finished booting. This is only useful for 
  949. configurations which you do not want to assign to a preset button.
  950.  
  951. The dialogue can contain a list of up to sixty program names, these 
  952. names can be easily selected and passed back to the AUTO BOOT window 
  953. by clicking on one and choosing OK. This program will only be passed 
  954. back to Desktop for running if the GO button is used to exit Stoop.
  955.  
  956. ADD
  957. This brings up the fileselector and allows you to add another name to 
  958. the program list.
  959.  
  960. REMOVE
  961. This will delete the name which has been highlighted.
  962.  
  963. MERGE
  964. This will search the preset button configurations and add any new 
  965. program names found to the program list.
  966.  
  967. FSEL
  968. This brings up the file selector, the program list dialogue will exit 
  969. if OK on the file selector is used, any file name chosen will be 
  970. passed immediately to the AUTO BOOT window.
  971.  
  972. NONE
  973. This exits the dialogue and clears the AUTO BOOT window.
  974.  
  975. CANCEL
  976. Exits the dialogue and leaves the AUTO BOOT window unchanged, though 
  977. any changes made to the program list are retained.
  978.  
  979.  
  980.               Option Controls
  981.  
  982. The six buttons near the bottom of the control panel make Stoop a bit 
  983. easier to use.
  984.  
  985. FSEL
  986. Brings up the file selector.
  987.  
  988. DELETE
  989. Used to wipe buttons, boards and groups. Simply click on the DELETE 
  990. button and then on the button, board or group to be wiped. Remember to 
  991. SAVE the changes afterwards!
  992.  
  993. SAVE
  994. Saves all the data Stoop needs to remember your requirements.
  995.  
  996. CLEAR
  997. De-selects all files on all boards.
  998.  
  999. CONFIG
  1000. This button allows to change the configuration of Stoop and your 
  1001. Falcon. When you click on it, a dialogue will appear which is in two 
  1002. parts separated by a groove. On the right are four buttons, SYSTEM, 
  1003. START UP, COLOURS and QUIT, and on the left is a dialogue. When you 
  1004. first click on CONFIG the dialogue will be the 'System Controls' 
  1005. dialogue, and the SYSTEM button on the right will be depressed. If you 
  1006. click on START UP or COLOURS the dialogue will change.
  1007.  
  1008. SYSTEM Dialogue
  1009.  
  1010.     The first three controls are self-explanatory, you can turn on or 
  1011.     off the following;
  1012.  
  1013.     (i)     the CPU cache (leave it on, as it accelerates your Falcon, 
  1014.             especially if the code has been written to take advantage 
  1015.             of it),
  1016.  
  1017.     (ii)     the system bell, this makes the high pitched ping when you 
  1018.             an error occurs (such as clicking the mouse on another 
  1019.             part of the screen when a dialogue is shown), and
  1020.  
  1021.     (iii)    the key clicks, this is the sound made by your Falcon when 
  1022.             a key is pressed.
  1023.     
  1024.     The Sound Level slider controls the volume of the sound from your 
  1025.     internal speaker or from the stereo output at the back of the 
  1026.     machine. To change it, the slider can be dragged (to the left to 
  1027.     increase volume) or the mouse can be click on the position you 
  1028.     want the slider to move to and the buttons on either end can be 
  1029.     used for fine adjustment.
  1030.  
  1031.     The Sound Balance is only useful if you have stereo speakers 
  1032.     attached to your Falcon, it controls the relative volumes of the 
  1033.     left and right speakers.
  1034.  
  1035.     Both of these controls make a sound as you use them, this enables 
  1036.     you to judge what you are setting.
  1037.  
  1038.     The UNDO button will remove the adjustments you have made, however 
  1039.     once the dialogue is exited the adjustments are not remembered and 
  1040.     subsequently cannot be undone by this button.
  1041.  
  1042.  
  1043. INITIAL Dialogue
  1044.     
  1045.     This dialogue allows you to choose what resolution settings and 
  1046.     what Autoboot program to be displayed at start up.
  1047.     
  1048.     Screen Resolution
  1049.     
  1050.     You can select which number of colours, width or height of the 
  1051.     screen. When you click on any of these buttons a popup will appear 
  1052.     with all of the possible settings, the current setting is 
  1053.     highlighted. Click on the option you want and the change will be 
  1054.     made, if you want to exit the popup without making a change you 
  1055.     can (i) click anywhere on the screen except on the list or (ii) 
  1056.     you can click on the highlighted item in the list.
  1057.     
  1058.     The NEWDESK option in the list allows you use the screen 
  1059.     resolution set up for the Desktop at the previous boot up.
  1060.     
  1061.     Autoboot
  1062.     
  1063.     The Autoboot program can be set in three different way, again a 
  1064.     popup is used to make the choice easier. NONE means that the entry 
  1065.     in AUTOBOOT at boot up will be empty, NEWDESK means that the 
  1066.     autoboot program from the last configuration set up will be used 
  1067.     and DEFAULT will allow you to show the same autoboot program each 
  1068.     time you use Stoop, this requires the Default to be set.
  1069.     
  1070.     Clicking on the small window next to Default will bring up the 
  1071.     Choose Autoboot Program dialogue, from this point you can select a 
  1072.     program from the list.
  1073.  
  1074. START UP Dialogue
  1075.  
  1076.     This allows you to decide how Stoop does (or does not) start up 
  1077.     during boot up. It is split into two sections.
  1078.  
  1079.     A. Bypassing Stoop
  1080.  
  1081.     In the top section of the dialogue you can decide if
  1082.  
  1083.     (i)        Stoop is bypassed if the specified keys are held down 
  1084.             (select BYPASS).
  1085.  
  1086.     (ii)    Stoop only runs if the specified keys are held down 
  1087.             (select CALL).
  1088.  
  1089.     (iii)    Stoop only runs during a cold boot (select COLDBOOT).
  1090.  
  1091.     The row of buttons below BYPASS, CALL and COLDBOOT specify the 
  1092.     keys you want to use.
  1093.  
  1094.     CTRL = Control key, L-SH = Left Shift key, R-SH = Right Shift key, 
  1095.     ALT = Alternate key and CAPS = Caps Lock.
  1096.  
  1097.     These keys need to be held down when the Stoop message first 
  1098.     appears on the screen or immediately after (if your STOOP.CFG is 
  1099.     large, you will have more time to press the required key or keys). 
  1100.     Caps Lock is the exception, you will only need to press and 
  1101.     release this once at any time during the initial boot up stages.
  1102.  
  1103.     If you specify more than one key, then all of these keys need to 
  1104.     be pressed together to have any effect.
  1105.  
  1106.     Please note, the Caps Lock is not turned off by Stoop, so all 
  1107.     keyboard entries will be in upper case if you use it and do not 
  1108.     cancel it's action afterwards.
  1109.  
  1110.     B. Access to Stoop
  1111.  
  1112.     In the bottom section of the dialogue, you decide if access is 
  1113.     given by
  1114.  
  1115.     (i)        entering a password to access Stoop,
  1116.  
  1117.     (ii)    having Stoop wait a set period for you to use it and if 
  1118.             nothing happens it will set up a default configuration and 
  1119.             exit, or
  1120.  
  1121.     (iii)    neither of these.
  1122.  
  1123.     Only one of these options is viable at any one time.
  1124.  
  1125.     To set the password, click on CHANGE PASSWORD, if you already have 
  1126.     a password set up you will be asked for it before you can replace 
  1127.     it. The password will be not be displayed but an asterisk will be 
  1128.     used to show each character as it is entered, it may be edited by 
  1129.     using Backspace or wiped by using Esc. The new password has to be 
  1130.     entered twice, press return after each one.
  1131.  
  1132.     To make Stoop ask for the password when it starts up, click on 
  1133.     PASSWORD to depress it. You will have to save these changes for 
  1134.     them to take effect next time you run Stoop.
  1135.  
  1136.     To make Stoop do a time-out when it starts up, click on TIMEOUT. 
  1137.     To set the time you want Stoop to wait, edit the Time delay, it 
  1138.     can have a value ranging from 0 to 999 and the unit of measurement 
  1139.     can be seconds (s), minutes (m) or hours (h). You do not have to 
  1140.     leave a space between the number and the unit.
  1141.  
  1142.     To select the default configuration you can simply press the key 
  1143.     that you require. Please note that F10 is aliased with Control F1, 
  1144.     i.e. pressing F10 is the same as pressing Control F1, and Control 
  1145.     F10 is equivalent to Alternate F1, but Alternate F10 has no alias.
  1146.  
  1147.     If you choose zero for the time delay value, Stoop will 
  1148.     automatically set up the default configuration and exit. If you 
  1149.     want to change the way Stoop starts up at a later date, you will 
  1150.     have to run Stoop from the Desktop (minimum resolution 640 x 480 
  1151.     by 16 colours).
  1152.  
  1153.  
  1154. COLOURS Dialogue
  1155.  
  1156.     The colours used by Stoop can be changed in this dialogue, this 
  1157.     has no effect on the colours used by the Desktop. Simply click on 
  1158.     the colour you wish to change and then adjust the RGB sliders.
  1159.  
  1160.     The UNDO button offers two levels of undo, if you have made 
  1161.     changes to the colours, the first click on this button will remove 
  1162.     the changes. The second click will offer you the choice of 
  1163.     reverting back to the original Stoop colours, a third click will 
  1164.     revert back to the colours you have just selected if you make the 
  1165.     wrong choice at this point.
  1166.  
  1167.  
  1168. INITIAL
  1169.  
  1170. Clicking on this button causes all the files on all the boards to be 
  1171. changed to their initial setting (active or inactive) when Stoop was 
  1172. first started up.
  1173.  
  1174.  
  1175.           Manual Start Up Configurations
  1176.  
  1177. Sometimes you may want to use a particular start up configuration just 
  1178. once, and as it does need to be used again assigning it to a preset 
  1179. button is a waste of time.    This is what to do instead :-
  1180.  
  1181. 1.     Set up the files on the boards as you want them (I often show the 
  1182.     contents of a preset (by using the right mouse button), which has 
  1183.     the nearest configuration to what I require, to give a position to 
  1184.     start from).
  1185.  
  1186. 2.    If you want to auto-boot a program, click on the AUTO BOOT text 
  1187.     box (near the bottom of the control panel), this will bring up the 
  1188.     file selector. Select the file you want and exit.
  1189.  
  1190. 3.    Click on GO.
  1191.  
  1192. Example.
  1193.  
  1194. How to change the resolution of a preset configuration from 16 to 256 
  1195. colours.
  1196.  
  1197. 1.     Show the contents of the preset by clicking the right mouse button 
  1198.     on the preset button.
  1199.  
  1200. 2.    Now click on the preset button.    (The SHOW button will pop up.)
  1201.  
  1202. 3.    Make the change by clicking on the 256 button.
  1203.  
  1204. At this point you have three options, you can:-
  1205.  
  1206. (i)        use the BUTTON button to re-assign the new configuration to 
  1207.         the old preset button,
  1208.  
  1209. (ii)    use the BUTTON button to assign the new configuration to 
  1210.         another preset button and
  1211.  
  1212. (iii)    press GO, which will use the current set-up without saving it 
  1213.         so that it might be used again.